Preview

https://github.com/MikeMcC399/node-gyp/blob/python-install-windows-doc/README.md#on-windows

@cclauss

Alternatively we could point to the Windows install manager at:

• https://www.python.org/downloads/windows

Pointing to the documentation https://docs.python.org/3/using/windows.html gives more comprehensive information, including different choices of where to get the Python install manager for Windows and how to use the Python install manager.

When I started to migrate to Python 3.14 I found that I needed this documentation.

If you want to point instead to the download page, https://www.python.org/downloads (one level higher) presents simpler information. The contents depends on the operating system where the browser is running and from Windows it looks like this:

this is easier on the eyes compared to https://www.python.org/downloads/windows

https://www.python.org/downloads/windows

Another possibility would be to use https://www.python.org/downloads and include a link to https://docs.python.org/3/using/windows.html

That may be the best way.

Would be great to hear also from @StefanStojanovic about his thoughts!

My original (short) suggestion, which delegates the instructions to the Python docs, is:

Follow the instructions in Using Python on Windows to install the current version of Python.

An alternate longer suggestion, which links directly to the download location options would be:

To install the current version of Python use the Python Install Manager, which can be installed from the Microsoft Store app or downloaded and installed from python/downloads. Refer to the documentation Using Python on Windows for Python Install Manager usage instructions.

I prefer the shorter version.

Generally speaking, I'm more in favor of shorter docs, as long as it gives all the info you need.

Is readme: all right for the commit message? I took it from release-please-config.json or would doc: or docs: be preferred?

@StefanStojanovic

Thanks for your feedback! Are you (or @cclauss) ready to approve this PR? If not, could you advise what I should change?